Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[blog] Announce JS SDK 2.0 #6574

Open
wants to merge 9 commits into
base: main
Choose a base branch
from

Conversation

JamieDanielson
Copy link
Member

@JamieDanielson JamieDanielson commented Mar 19, 2025

OpenTelemetry JavaScript recently released SDK 2.0. There have been many improvements and breaking changes and we want to make this easily findable.


Preview: https://deploy-preview-6574--opentelemetry.netlify.app/blog/2025/otel-js-sdk-2-0/

@opentelemetrybot opentelemetrybot requested a review from a team March 19, 2025 18:48
@github-actions github-actions bot added the blog label Mar 19, 2025
@JamieDanielson JamieDanielson requested review from a team and maryliag and removed request for a team March 19, 2025 18:48
@opentelemetrybot opentelemetrybot requested a review from a team March 19, 2025 18:52
[v2.0.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v2.0.0)
and
[v0.200.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/experimental%2Fv0.200.0)
releases and provide feedback
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

do you want to add something on how to provide feedback? I see people getting confused on how to do so. Maybe mention creation of issues, or reaching our slack/SIG. I know you added slack and sig right below, but wanted to make more clear those are the communications channels for feedback too

Copy link
Contributor

@trentm trentm Mar 19, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The upgrade guide has this blurb, FWIW:

If you have any questions about the 2.x changes, please ask! You can reach the OTel JS community on the [#otel-js](https://cloud-native.slack.com/archives/C01NL1GRPQR) channel of the [CNCF Slack](https://slack.cncf.io/), [open a Discussion issue](https://github.com/open-telemetry/opentelemetry-js/issues/new?template=discussion.md) on the repository, or join the weekly [OTel JS SIG zoom call](https://docs.google.com/document/d/1tCyoQK49WVcE-x8oryZOTTToFm7sIeUhxFPm9g-qL1k/edit).

If you have any questions about the 2.x changes, please ask! You can reach the OTel JS community on the #otel-js channel of the CNCF Slack, open a Discussion issue on the repository, or join the weekly OTel JS SIG zoom call.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh... I guess the subsequent few bullets include links on how to get involved.

Copy link
Contributor

@trentm trentm left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice. LGTM.

@opentelemetrybot opentelemetrybot requested a review from a team March 20, 2025 09:47
---
title: Announcing the OpenTelemetry JavaScript SDK 2.0
linkTitle: OTel JS SDK 2.0
date: 2025-02-21
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
date: 2025-02-21
date: 2025-02-20

@opentelemetrybot opentelemetrybot requested a review from a team March 20, 2025 09:52
Copy link
Contributor

@chalin chalin left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great to see a blog post about the new release. See inline comments for preliminary suggestions.

@chalin
Copy link
Contributor

chalin commented Mar 20, 2025

/fix:refcache

@opentelemetrybot
Copy link
Collaborator

You triggered fix:refcache action run at https://github.com/open-telemetry/opentelemetry.io/actions/runs/13966803156

@opentelemetrybot
Copy link
Collaborator

fix:refcache was successful.

IMPORTANT: (RE-)RUN /fix:all to ensure that there are no remaining check issues.

@chalin
Copy link
Contributor

chalin commented Mar 20, 2025

@chalin chalin force-pushed the jamie.blog-oteljs-sdk-2-0 branch from 9d7e359 to d0359b8 Compare March 20, 2025 10:47
@opentelemetrybot opentelemetrybot requested a review from a team March 20, 2025 10:47
@chalin
Copy link
Contributor

chalin commented Mar 21, 2025

@JamieDanielson @open-telemetry/javascript-approvers - I'm curious, what is your ETA for finalization of this post?

@JamieDanielson JamieDanielson marked this pull request as ready for review March 21, 2025 19:18
@JamieDanielson JamieDanielson requested a review from a team as a code owner March 21, 2025 19:18
@JamieDanielson
Copy link
Member Author

@JamieDanielson @open-telemetry/javascript-approvers - I'm curious, what is your ETA for finalization of this post?

I am heading out of town for the weekend. I committed a few suggestions, and if anyone has other ideas on what else to add please do so! I think this should be ready to go.

@chalin
Copy link
Contributor

chalin commented Mar 21, 2025

/fix:all

@opentelemetrybot
Copy link
Collaborator

You triggered fix:all action run at https://github.com/open-telemetry/opentelemetry.io/actions/runs/13999356748

@opentelemetrybot
Copy link
Collaborator

fix:all was successful.

IMPORTANT: (RE-)RUN /fix:all to ensure that there are no remaining check issues.

@chalin chalin force-pushed the jamie.blog-oteljs-sdk-2-0 branch from 719e321 to bcc6a27 Compare March 21, 2025 19:31
@chalin chalin changed the title blog[js]: Add post announcing JS SDK 2.0 [blog] Announce JS SDK 2.0 Mar 21, 2025

## What has changed?

### Summary
Copy link
Contributor

@chalin chalin Mar 21, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There isn't enough content to justify section headings IMHO. Let's inline these a paragraphs:

Suggested change
### Summary
In summary:

- for notes on migrating to 2.x / 0.200.x see
[the upgrade guide](https://github.com/open-telemetry/opentelemetry-js/tree/main/doc/upgrade-to-2.x.md)

### Details
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Details
Details:

Comment on lines +62 to +74
Some of the details for why this 2.0 was done can be found
[in this issue](https://github.com/open-telemetry/opentelemetry-js/issues/4083).
We knew we would gain the greatest benefit by allowing breaking changes to
improve things related to:

- Optimization: removing classes and namespaces to allow better minification and
tree-shaking.
- Better Tooling and Support: dropping old runtimes and tool versions to take
advantage of enhanced ESM support and simplify documentation.
- Velocity: reducing code complexity and removing deprecated fields for faster
feature and maintenance work.

This also begins our goal of releasing a new major release every year.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Move the "for more details" to the end of the post:

Suggested change
Some of the details for why this 2.0 was done can be found
[in this issue](https://github.com/open-telemetry/opentelemetry-js/issues/4083).
We knew we would gain the greatest benefit by allowing breaking changes to
improve things related to:
- Optimization: removing classes and namespaces to allow better minification and
tree-shaking.
- Better Tooling and Support: dropping old runtimes and tool versions to take
advantage of enhanced ESM support and simplify documentation.
- Velocity: reducing code complexity and removing deprecated fields for faster
feature and maintenance work.
This also begins our goal of releasing a new major release every year.
We knew we would gain the greatest benefit by allowing breaking changes to
improve things related to:
- Optimization: removing classes and namespaces to allow better minification and
tree-shaking.
- Better Tooling and Support: dropping old runtimes and tool versions to take
advantage of enhanced ESM support and simplify documentation.
- Velocity: reducing code complexity and removing deprecated fields for faster
feature and maintenance work.
This also begins our goal of releasing a new major release every year.
For a more detailed explanation of why 2.0, see issue [#4083].
[#4083]: https://github.com/open-telemetry/opentelemetry-js/issues/4083

Comment on lines +11 to +12
Exciting news: [OpenTelemetry JavaScript](/docs/languages/js/) has released
[SDK 2.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v2.0.0)!
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Exciting news: [OpenTelemetry JavaScript](/docs/languages/js/) has released
[SDK 2.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v2.0.0)!
Exciting news: [OpenTelemetry JavaScript](/docs/languages/js/) has released [SDK
2.0][v2.0.0]!
[v2.0.0]: https://github.com/open-telemetry/opentelemetry-js/releases/tag/v2.0.0

FYI: the same link definition is used further below in another suggestion.

Comment on lines +78 to +82
- Try out the
[v2.0.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v2.0.0)
and
[v0.200.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/experimental%2Fv0.200.0)
releases and provide feedback
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Try out the
[v2.0.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v2.0.0)
and
[v0.200.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/experimental%2Fv0.200.0)
releases and provide feedback
[v0.200.0]:
https://github.com/open-telemetry/opentelemetry-js/releases/tag/experimental%2Fv0.200.0
- Try out the [v2.0.0] and [v0.200.0] releases and provide feedback

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
Status: No status
Development

Successfully merging this pull request may close these issues.

5 participants